Como usar a nossa API para impostos

Última atualização: 31/03/2025

Uma Interface de Programação de Aplicações (API) é uma forma de diferentes serviços (corretoras e serviços fiscais, neste caso) interagirem entre si.

Por vezes, os serviços podem comunicar livremente usando dados publicamente disponíveis via API, no entanto, quando se trata de consultar as informações necessárias para impostos (como os saldos da sua conta, histórico de transações, etc.), as coisas tornam-se mais complexas, porque esta informação é protegida pelo seu nome de utilizador/palavra-passe/2FA (que nunca deve partilhar com ninguém).

Usar uma API para ligar a sua plataforma fiscal à sua conta Kraken é uma forma eficiente de permitir o acesso aos dados da sua conta sem partilhar as suas informações de início de sessão.

Para ligar a sua plataforma fiscal à sua conta Kraken, precisa de dar à plataforma fiscal acesso às informações da sua conta através de uma chave API.

Não quer que terceiros saibam o seu nome de utilizador/palavra-passe/2FA, nem quer que eles transacionem ou levantem fundos da sua conta, por isso é utilizada uma chave API com as permissões apropriadas.

As permissões que atribui à chave API definirão os limites do que a outra plataforma pode ver e fazer na sua conta.

De um modo geral, as permissões necessárias para um software fiscal calcular os seus ganhos/perdas de capital são as seguintes:

Consultar fundos, Consultar ordens e transações fechadas (opcional para algumas corretoras), Consultar entradas de registo e Exportar dados.

Estas são conhecidas como permissões de apenas leitura, o que significa que permitem que a outra plataforma veja os fundos na sua conta, bem como as transações no seu histórico de conta, mas não lhes permitem fazer quaisquer alterações na sua conta (nenhumas novas transações e nenhumas novas transações de financiamento).

Vejamos como isto se apresenta no Kraken PRO:

Kraken PRO

Para saber como criar uma API na Kraken, consulte abaixo.

Fundos:

Consultar: isto permite que a chave API visualize o saldo da conta e os registos de financiamento (depósitos e levantamentos históricos) na conta.

Ordens e transações:

Consultar ordens e transações fechadas: isto permite que a chave API veja as ordens e transações fechadas na conta (isto é usado para ajudar a determinar lucros/perdas).

Dados:

Consultar Entradas de Registo: isto permite que a chave API visualize o registo da conta, que é um registo de todas as transações passadas de negociação/financiamento.

Exportar Dados: isto permite que a chave API exporte todos os dados mencionados acima, incluindo o seu histórico de negociação e registo da conta (geralmente em formato CSV).

Para mais informações sobre como ligar a sua conta Kraken à Koinly, visite:

Comece por selecionar o seu país de residência

1

Em seguida, clique em Adicionar Carteira e selecione Kraken

2

Para usar o método de 'Sincronização Automática' da API, insira a sua Chave Pública e Privada obtidas em Kraken.com e clique em Adicionar Kraken.

3

3

4

Para carregar manualmente o seu ficheiro CSV, por favor, reformate os seus dados usando o guia CSV da CoinTracker e carregue-os no modelo CSV da CoinTracker.

Assim que isto estiver concluído, arraste e largue o modelo CSV da CoinTracker preenchido para a área de carregamento designada.

5

Se precisar de mais assistência, consulte o guia passo a passo da CoinTracker abaixo.

Na página principal, defina as suas configurações básicas

1

Clique em próximo passo, seguido de 'ver mais opções'

2

Selecione Kraken da lista de carteiras/corretoras

4

5

Por favor, copie e cole as suas chaves Pública e Privada da Kraken nos campos Chave API e Chave Secreta e clique em "Ligar Corretora"

4

Na página principal, por favor, selecione 'Inserir Moedas' e procure e selecione Kraken (Não confundir com Kraken Futures)

Select Exchange/Wallet

Desça até 'Criar um novo trabalho automático Kraken' e cole a Chave API, bem como a sua Chave Privada API (secreta), depois clique em 'Guardar Este Trabalho Kraken'

Input Public/Private Keys

Para carregar manualmente o seu ficheiro CSV, clique no separador 'Importar CSV', depois arraste e largue o seu ficheiro CSV e clique em 'Continuar a Importar'.

Manually Upload CSV file

Por fim, por favor, clique em 'Iniciar Importação'

Manually upload CSV file

Successfully uploaded CSV file

Se precisar de mais assistência, consulte o guia passo a passo da CoinTracking abaixo:

Para um guia completo sobre como carregar dados da Kraken para o Crypto Tax Calculator (CTC), visite o nosso artigo de suporte:

Na página do painel de controlo, selecione o botão + Integração no canto superior direito:

Blockpit

Em seguida, selecione Kraken quando for solicitado a selecionar uma Carteira.

Está visivelmente listado em Integrações Mais Populares.

Em seguida, por favor, selecione Kraken (para Dados API Spot) ou Kraken Futures (para Dados de Futuros).

*Por favor, note que as Chaves API do Kraken Futures são separadas e distintas das Chaves API SPOT do Kraken e não podem ser usadas de forma intermutável*

Blockpit

Blockpit 3

Por favor, copie a sua Chave API e a sua Chave Privada da API da sua conta Kraken e cole-as nos campos correspondentes no website da Blockpit e clique em Continuar.

Blockpit 3

Após clicar em 'Continuar', o processo de sincronização dos saldos da sua conta e do histórico de transações terá início. Isto pode demorar alguns segundos ou minutos, dependendo da extensão do histórico da sua conta.

Blockpit 4

Os seus saldos Kraken (e Kraken Futures) serão apresentados em Integrações no Painel de Controlo, onde poderá sincronizar os dados a qualquer momento, ou tê-los sincronizados automaticamente a cada 24 horas com uma licença Blockpit ativa.

Se precisar de mais assistência, por favor, consulte o guia passo a passo da Blockpit abaixo.

  • Estou a receber um erro de chave inválida ao adicionar a minha Chave Pública e Privada a um software de terceiros.

    Se lhe for apresentado este erro, primeiro certifique-se de que está a copiar as chaves privada e pública corretamente. Se estiver a fazê-lo e ainda assim receber o erro de chave inválida, por favor, crie uma nova chave com as permissões corretas e tente adicioná-la novamente.

  • Os meus saldos de Earn/Staked não estão a aparecer.

    Alguns softwares de impostos de terceiros não conseguem importar corretamente os nossos saldos de ativos em staking via API. Isto pode geralmente ser remediado exportando o seu histórico de conta e carregando-o manualmente para o site de terceiros. Para saber como exportar manualmente o seu histórico de conta, por favor, clique abaixo.

  • Algumas das minhas transações estão em falta.

    As funções de compra/venda instantânea não são registadas no histórico de negociações da conta, no entanto, podem ser vistas no Livro-Razão da conta. Algumas plataformas de terceiros não conseguem interpretar corretamente as entradas de compra/venda no Livro-Razão da conta. Se for este o caso, por favor, exporte manualmente o seu histórico de conta e carregue o ficheiro para a plataforma de terceiros que está a utilizar.

  • Descarreguei manualmente o meu histórico de conta, mas não compreendo o que os símbolos significam.

    O seu histórico de conta completo é composto por duas partes, nomeadamente o seu Livro-Razão e as suas Negociações. Primeiro, vamos aprender um pouco sobre as diferenças entre os dois.

    Agora que temos uma boa compreensão das diferenças entre o Livro-Razão da sua conta e o histórico de Negociações, vamos ver como interpretar cada um.

  • É seguro fornecer as minhas chaves API a um software de terceiros?

    Enquanto um site/aplicação de terceiros exigir as suas chaves API privadas da Kraken, podem existir potenciais problemas de segurança, mas desde que crie uma chave API específica com permissões mínimas, por exemplo, apenas para ler o seu saldo e/ou livro-razão, não há risco para os seus fundos ou segurança em geral. Por esta razão, é aconselhável conceder permissões apenas de leitura e criar uma chave API específica com as referidas permissões para partilhar com o seu software de terceiros de confiança.


Precisa de mais ajuda?